Inside Macintosh: Telephony /

Chapter 1 - Introduction to Telephony on the Macintosh

This chapter provides an introduction to managing telephones on Macintosh computers. It's intended to help you quickly get started integrating telephony into your application. This chapter introduces the concepts described in detail throughout the rest of this book and provides source code examples that show you how to use the most basic telephony capabilities of Macintosh computers.

This chapter also describes how to use the functions provided by the Telephone Manager and how to work with the telephone tools needed to manage the features of a given telephone terminal. You should read this chapter to determine the preliminary steps you must follow to initialize the Telephone Manager, to create a telephone record, and to configure and work with the available telephone tools.

To benefit most from this chapter, you should already be familiar with the Communications Toolbox, of which the Telephone Manager is a part. The programming interfaces provided by the Telephone Manager are closely analogous to those provided by other Communications Toolbox managers. See the book Inside the Macintosh Communications Toolbox for a complete description of the Communications Toolbox.

This chapter begins with an overview of telephone management on Macintosh computers. It describes the Telephone Manager and how it works with the Communications Toolbox and other Macintosh system software managers. The section "Using Telephony on Macintosh Computers," beginning on page 1-12, describes how you can use the Telephone Manager to

• find and configure a telephone tool
• create a telephone record
• open a telephone terminal

You need to perform these tasks before you can call any Telephone Manager functions that manipulate telephone terminals, directory numbers, or call appearances.

The section "Telephone Manager Initialization Reference," beginning on page 1-21, provides a complete description of the constants, data structures, and functions you can use to initialize and configure the Telephone Manager and its associated telephone tools.

---

Chapter Contents

About Telephony on Macintosh Computers

Telephone Tools

Local and Remote Operations

Sound Streams

Telephone Terminals

Directory Numbers

Call Appearances

Using Telephony on Macintosh Computers

Determining if the Telephone Manager Is Available

Initializing the Telephone Manager

Finding Telephone Tools

Creating Telephone Records

Configuring Telephone Tools

Opening a Telephone Terminal

Telephone Manager Initialization Reference

Constants

Gestalt Selector and Response Values

Telephone Record Flags

Handle Types

Tool Choosing Result Codes

Data Structures

Telephone Record

Feature List Structure

Telephone Manager Initialization Functions

Initializing the Telephone Manager

Obtaining Tool IDs

Creating, Initializing, and Validating a Telephone Record

Configuring a Telephone Tool with the Standard Interface

Configuring a Telephone Tool Through a Custom Interface

Configuring a Telephone Tool Through a Scripting Language

Localizing Configuration Strings

Working With a Telephone Tool

Passing Events to a Telephone Tool for Processing

Result Codes

Telephone Manager Initialization Summary

C Summary

Constants

Data Types

Telephone Manager Initialization Functions

Pascal Summary

Constants

Data Types

Telephone Manager Initialization Functions